home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Memphis Amiga Group / MAG Disk (1990-06)(Memphis Amiga Group).zip / MAG Disk (1990-06)(Memphis Amiga Group).adf / PopUpMenu.doc < prev    next >
Text File  |  1990-04-15  |  5KB  |  143 lines
  1.     PopUpMenu V3.2 by Martin Adrian           90-04-11
  2.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.     Introduction
  5.     ~~~~~~~~~~~~
  6.     Are you using QMose, DMouse, or HeliosMouse and "always" get the wrong
  7.      menues when you press the mousebutton?
  8.     Have you ever needed pop-up menues for your Amiga?
  9.  
  10.     The solution: PopUpMenu
  11.  
  12.     What is it ?
  13.     ~~~~~~~~~~~~
  14.     This small program makes it possible for You to use popupmenues with
  15.      every program that uses standard intuition menues.
  16.      ~~~~~
  17.     The popupmenues works just like the standard pull-down menues for both
  18.      the user (multiple selections, checkmarks, commandkeys) and the
  19.      programmer (MENUPICK and MENUVERIFY).
  20.      All intuition menu-flags (COMMSEQ, HIGHBOX, MENUTOGGLE ...)
  21.      are fully supported.
  22.  
  23.     Features:
  24.     ~~~~~~~~~
  25.     * The Pop-up menues will not show up when you press the menubutton
  26.        if any of the following conditions are true:
  27.  
  28.        1) No window is active.
  29.        2) The active window has no menues.
  30.        3) The active window has the flag RMBTRAP set.
  31.        4) The active window has a requester open.
  32.        5) The mousepointer is in the screens menubar.
  33.       (standard pull-down menues will appear)
  34.        6) You are pressing any qualifier key.
  35.       (shift, alt, ctrl, left or right Amiga, left (or middle) mousebutton)
  36.  
  37.     * If a menuitem has subitems this is marked with a small arrow.
  38.  
  39.     * The program remembers the last menu selected.
  40.        (Works only with items selected with PopUpMenues and does not remember
  41.     different windows).
  42.  
  43.    Differences from Intuition:
  44.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45.    Bad:
  46.      Drag-select is not supported (i never use it), Use Multiple selcet.
  47.      If a Menu is disabled the menuitems will not show up.
  48.      PopUpMenu does not sort the menues after their LeftValue (they may
  49.       show up in the wrong order).
  50.  
  51.    Good:
  52.      Mousepointer don't stop while menuwindows are opened or closed.
  53.  
  54.    Installation:
  55.    ~~~~~~~~~~~~
  56.    To use the program put the file `PopUpMenu' and 'PopUpMenu.info'
  57.      in your current directory.
  58.  
  59.    To turn on the pop-up menues just type:
  60.  
  61.      1> PopUpMenu
  62.  
  63.    (If You (or maybe Kickstart 1.4) don't like selfdetaching programs,
  64.      RUN the PopUpMenu.run program)
  65.  
  66.    To turn them off, just type:
  67.  
  68.      1> PopUpMenu
  69.  
  70.    Workbench users can click the PopUpMenu-icon.
  71.  
  72.    The program will take up < 10K. (including stack)
  73.  
  74.    Distribution
  75.    ~~~~~~~~~~~~
  76.  
  77.    This version of the PopUpMenu program is released as Public Domain.
  78.                             ~~~~~~~~~~~~~~
  79.      This program can be used, copied, included in a library or commercial
  80.      product as long as You don't do it for profit.
  81.  
  82.      You may also use the source for your own programs, but if You intend
  83.      to do a similar popupmenu-program with it please let me know.
  84.  
  85.    Warnings:
  86.    ~~~~~~~~~
  87.    * A bug in intuition will sometimes lock the inputhandler (Mousepointer
  88.        and keyboard will freeze).  This happens when intuition tries to change
  89.        the screen (i.e draw something) while menues are displayed.
  90.      The PopUpMenu program will detect this, fix it, and then resume the
  91.        menuoperation. (The menues flashes once).
  92.  
  93.    * It is not possible to remove older versions (2.42 and lower) with
  94.        this program.
  95.  
  96.    FUTURE:
  97.    ~~~~~~~
  98.     Size is to big.
  99.  
  100.     The program only remembers the last menu (not menuitem or subitem) selected.
  101.  
  102.  
  103.    Author:
  104.    ~~~~~~~
  105.      Martin Adrian                              o
  106.      Motgangen 305            (the a is an 'a' with a ring above -> a)
  107.      S-412 80  Gothenburg
  108.      Sweden
  109.  
  110. USENET d5adria@dtek.chalmers.se  (not sure if this works anymore)
  111.  
  112.    Thanks to:
  113.     Derek Zahn          for the PopUpMenu program on FishDisk 96
  114.     Commodore          for the Amiga
  115.     Arp - people          for Arp 1.3 & AShell
  116.     Lattice           for the C compiler (5.0)
  117.     My English teatcher
  118.     Anna              my girlfriend
  119.     You              for using this program.
  120.  
  121.  
  122.    Differences from version 2.42
  123.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  124.    For speed:
  125.    * Some code optimizations (C -> Assembler).
  126.  
  127.    For safety:
  128.    * MENUVERIFY is now fully supported.
  129.    * Forbid() and LockIBase() is now used where needed. (I hope.)
  130.    * Made my own SwapBitsRastPortClipRect.   (No more guru #81000005)
  131.  
  132.    For use:
  133.    * Shows if an item has subitems.
  134.    * Now always shows items & subitems (even if they cover other menuwindows).
  135.    * Now resumes after the intuition lock-up.
  136.  
  137.    For compability:
  138.    * Fixed Fontbug.
  139.  
  140.    New Distrbution:
  141.    * Public Domain.  (i'm not a poor student anymore 8-) )
  142.  
  143.